home *** CD-ROM | disk | FTP | other *** search
/ NOVA - For the NeXT Workstation / NOVA - For the NeXT Workstation.iso / Apps / AudioApps / CSound.app / manual / m1.linen < prev    next >
Encoding:
Text File  |  1992-12-21  |  2.9 KB  |  70 lines
  1. SIGNAL MODIFIERS
  2.  
  3. .nf
  4.     kr    \fBlinen\fR    kamp, irise, idur, idec
  5.     ar    \fBlinen\fR    xamp, irise, idur, idec
  6.     kr    \fBenvlpx\fR    kamp, irise, idur, idec, ifn, iatss, iatdec[, ixmod]
  7.     ar    \fBenvlpx\fR    xamp, irise, idur, idec, ifn, iatss, iatdec[, ixmod]
  8. .fi
  9.  
  10. \fBlinen\fR - apply a straight line rise and decay pattern to an input amp
  11. signal.  
  12. .br
  13. \fBenvlpx\fR - apply an envelope consisting of 3 segments: 1) stored
  14. function rise shape, 2) modified exponential "pseudo steady state", 3) true
  15. exponential decay
  16.  
  17.  
  18. INITIALIZATION
  19.  
  20. \fIirise\fR - rise time in seconds.  A zero or negative value signifies no
  21. rise modification.
  22.  
  23. \fIidur\fR - overall duration in seconds.  A zero or negative value will
  24. cause all initialization to be skipped.
  25.  
  26. \fIidec\fR - decay time in seconds.  A zero value indicates no decay
  27. modification.    A value greater than \fIidur\fR will cause a truncated
  28. decay pattern.
  29.  
  30. \fIifn\fR - function table number of stored rise shape with extended guard
  31. point.
  32.  
  33. \fIiatss\fR - attenuation factor, by which the last value of \fBenvlpx\fR
  34. rise pattern will become modified during the note's pseudo "steady state."
  35. A factor >1 will cause an exponential growth, and a factor <1 an
  36. exponential decay.  The value 1 will maintain a true steady state at the
  37. last rise value.  Note that this attenuation is not by fixed rate (as in a
  38. piano), but is sensitive to a note's duration.  However, if \fIiatss\fR is
  39. negative (or if "steady state" < 4 k-periods) a fixed attenuation rate of
  40. \fIabs(iatss)\fR per second will be used.  0 is illegal.
  41.  
  42. \fIiatdec\fR - attenuation factor by which the closing "steady state" value
  43. is to be reduced exponentially over the decay period.  This value must be
  44. positive and will normally be of the order of .01 .  A large or an
  45. excessively small value is apt to produce a cutoff which is audible.  A
  46. zero or neg value is illegal.
  47.  
  48. \fIixmod\fR (optional, between +-.9 or so) - exponential curve modifier,
  49. influencing the "steepness" of the exponential trajectory during the
  50. "steady state."  Values less than zero will cause an accelerated growth or
  51. decay towards the target (e.g. \fIsubito piano\fR).  Values greater than
  52. zero will cause a retarded growth or decay.  The default value is zero
  53. (unmodified exponential).
  54.  
  55.  
  56. PERFORMANCE
  57.  
  58. Rise-time modifications are applied for the first \fIirise\fR seconds, and
  59. decay-time modifications from time \fIidur - idec\fR.  If these two
  60. modification periods are separated in time there will be a real "steady
  61. state" period during which \fIamp\fR will be unmodified (\fBlinen\fR) or
  62. modified by the first exponential pattern (\fBenvlpx\fR).  For \fBlinen\fR,
  63. if the rise and decay periods overlap then both modifications will be in
  64. effect for that time; for \fBenvlpx\fR an overlap will simply cause a
  65. truncated decay pattern.  If the overall duration \fIidur\fR is exceeded in
  66. performance, the final decay pattern will continue on in the same
  67. direction, going negative for \fBlinen\fR but tending asymptotically to
  68. zero in the case of \fBenvlpx\fR.
  69. .bp
  70.